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My Two Bits 



InfoWorld's John Dvorak did a two-part 
series last fall on the characteristics of suc- 
cessful personal computers {Oct 15, 1984, 
page 88; Oct 22, 1984, page 80). After ex- 
amining a number of features of successful 
machines and showing that all of them were 
available on the ^ilures as well Dvorak 
argued that the "real common denominator 
for success" is ' heavy hobbyist enthusiasm 
and subsequent third-party software 
support" 

Thus. Dvorak said, the successful personal 
computer, ' has to have an easy-ti>-use pro- 
gramming language." He continued: 



There is no successful machine (and there never will be In our lifetimes) that 
cannot be programmed in Basic the people's ^nguage. 

Though Basic is not the world's greatest language, I submit that its ease of use 
makes it the perfect helpmate for the guy with the idea" This means the 
nonprogrammer who has an idea for a program, 

tie writes the Basic program and shows (maybe seUs) a compiled wersion— 
that is essentially the prototype. A sharpie can come in later and recede it This 
is the ken third-party support—support by the masses. 

Although professional programmers and computer snobs won't admit it 
there are more good ideas among the 250 million U.S. laypersons than among 
all the professional programmers in Uie world. If the masses of enthu^tk 
laypersons (a mi^is^ of the general public) aren't encouraged to support a 
computer —its dead. 

The Apple II, of course, has always had a wealth of third-party support Dvorak 
calls it and the IBN-PC the "all-time supersuccessful machines." And he's right 

But nearly eveiy personal computer ever built has been able to run Basic I 
agree that any successful personal computer will have to include an easy-to-use 
programming language, and Basic is also my choice, but Basic hardly divides the 
successful computers firom the losers. There is, in fact another element that 
separates the machines that ath'act technically-inclined laypeople from the 
machines that can't find a market Its not Basic and it's not any specific hardware 
feature, for many of the dead machines can match or better the successful ones in 
those categories. 

This iii)«terious factor is the willingness and ability of the manufacturer 
to expose the inner flesh of a machine to light of day. Assuming a new 
machine has a reasonable amount of features and a reasonable price, its success 
with "hobbyists" (and consequently with the general public) will depend on the 
quality of the information and development tools that are available to mere 
mortals. 

In the beginning, both Apple and IBM explained in great readable detail how 
their machines worked. At one time Apple included this information in a refer- 
ence manual that came in the box with its computer. The Apple It of course, also 
came with built-in Monitor software (examined at length in the February and 
March Open^A^iiesi which helped thousands of people to better understand 
how the machine worked. 



Measure the latest greatest products against this standard —the availability to 
the general public, of the information and the tools needed to build hardware and 
software enhancements and to connect them to the operating system— and 
you'll be able to tell whether a machine will be a success or not 

If Apple had released a decent development language and decent documenta- 
tion for the Macintosh the day they announced that computer, its sdes goals 
would have been shattered. Even the Apple He and 11c would be In stronger 
positions today if the reference manuals for those machines had been more 
readily available the last two years. 

While Addison-Wesle/s deal to distribute Apple's manuals, reported here last 
month, should vastly improve the availability of information about the Apple II to 
the general public, the machine has also been hurt because newcomers with 
technical questions can't get support from Apple. Apple's current policy is that 
members of the general public with technical questions should go to their 
dealers. 

What Is the most elementary kind of technical support a dealer can 
provide? Stocking the reference manuals would be one of the easiest and most 
helpful things a dealer could do. But many dealers don't do even that They say 
Apple makes them buy the books five at a time and Uiis means an investment of a 
little more than $200 to keep the He and lie reference manuals in stock, so they 
don't do it Many even refuse to accept special orders for the manuals. Where does 
dealer-based technical support go from here? (ror mudi more on this issue, see 
the Letters in the April 1985 Byte, page 23 and following.) 

The dealers and Apple can argue alt th^ want that the general public doesn't 
wantdetailed technical information. It is o/)y/oMs that most computer users could 
care less whether the microprocessor inside their machines is a 6502 or a DC-10. 
But that still leaves thousands of people, none of whom are certifiable "sofbvare 
developers," who want technical information. The rapid success of Open-Apple, 
the hundreds of user groups around ttie country, and the best-selling status of 
t)ooks like Beneath Apple DOS amply demonstrate tiiat there is a significant 
market for detailed technical information about tiie Apple II. 

I suspect tiie real reason dealers and Apple's marketing wizards don't recog- 
nize the size of this market is that they don't personally find technical information 
usefiil. Let's face it most sales engineers (Uiere are notable exceptions) are 
novice computer users. The result is situations such as the one that occurred with 
the FroDOS Technical Reference Wanuat Apple's documentation department had 
it written, published, and ready to ship a ftill month before ProDOS was released 
to tiie public in January 1984, But by February ttie entire stock of books had been 
sold out Apple's "System Soffavare Product Marketing" department apologized in 
a letter to one of our readers for the difficulty he encountered in obtaining a 
manual and noted, ^'we underestimated the demand." Indeed, tiiey did. 

But tiie crux of this issue isn't that there is a market for techncial information, it 
is that the long-term success of a computer is directly related to the amount and 
quality of technical information available to the general public It really doesn't 
matter whether those who desire technical information make up a significant 
portion of tiie market for a computer, the point is that if a computer company 
doesn't get and keep the technically inclined layperson interested in /te 
machine by providing for his or her needs, no one else will be interested in it 
either. 

The importance of the technically inclined layperson is twofold. First these are 
the people tiie general public turns to for advice about personal computers. The 
word-of-mouth advertising these people can put behind a product is priceless. 
Secondly, these are the people who ^d up writing tiie soflware, botii public 
domain and commerdal, and designing the hardware tiiat makes a personal 
computer worth ha\flng. (Consider, for example, tiie impact on Apple if Dan 
Bricklin and Paul Lutus, the two mere mortals who came out of nowhere to 
develop VZsfCa/cand ;4pple HHter, had written programs for Atari instead.) 
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What are the timits of the Apple ll's success? In an interview in InfoWorld 
(April 15, 1985, page 34), Del Yocam, head (rfApple's^pIe II Division, said: 

I have yet to find anyone willing to put anXu^ere he bellevestheAppleHisfn 
its product life q/cfe. Mfe really believe the Apple II can live forever, But we also 
resdize ft is incumbent upon us to make that happen. We are putting $50 million 
to $40 miUion into research and development for the Appie // product family to 
make sure that we incorporate those things thsA are exciting and ne<xssary to 
keep ehe machine isiifa£iii% {ntact 

For eight years nov^ Apple has been able to enhance the original ^le 11 design 
and keep the machine endowed iidth a reasonable amount of features at a 
reasonable price. Tor dghtyears iioii« Apple has been able to keep the tedinically 
Inclined layperson interested In its machine Uke Yocam, I really believe Apple 
could continue this forever (at least in computer-time), if it does things right 

Apple broke a considerable limitation to continued interest that of confined 
external storage space, when it released ProDOS. Third-party developers have 
broken a second major limitation, that of confined RAM, with advanced memory 
cards. We 11 take an extensive look atone of these and its implications in this issue 
of Open-Apple, The third major limitation of the Apple II is its microprocessor, 
the 6502. Typical of people's feelings is this comment from one of our readers, 
"We ask a lot of our little 6502-based Apples. Is it my imagination, or do I really 
hear these little 8-bit machines panting as they execute integrated software 
packages such as AppleWorks?" 

Apple appears to have enough money to break through the hardv^e limita- 
tions of the Apple II and appears, based on Yocam's comments, headed in that 
direction. But the m^tjor question at fills juncture is whether A|^ has enough 
sense to active^ and purposefully "expose the inner flesh" of these machines to 
interested membm of the general pid)l!c That is the Victor that has been shown 
to determine the ultimate success of any personal computer and tt^ includes 
present and fubire models of ttie venerable Apple II. 



RAMworte 

transforms 

AppleWorics 




Apple and its dealers have become very fond of selling the lie as a "system" that 
includes disk drives, a monitor, and other peripherals. While the lie itself is still 
one of the best computer buys anywhere, improved (and less expensive) versions 
of all that other stuff are widely available ft-om third-party vendors, notice that First 
Class Peripheral's 10 megabyte hard drive (reviewed here in February, page 10) is 
$30 cheaper than Apple's DuoDisk floppy and youll quickly get the picture. 

Right now Apple's competition is particularly fierce in the area of extended 
memoiy 80-column cards. Apple sells two versions of its own extended memory 
card. Both include 64K of RAM (bringing the lies the/re installed on up to 128K). 
The difference beMsen the tMD caids is that 
for attaching an ROB oilornionitor to the (»mpiiter(inore about 
letter); the other doesn't Since the price difierence between the two cards is a 
mere $4 ($295 vs $299), it appears at first glance that the "AppleColorCard"isa 
steal not to bemused. 

Tor Just $179^ howem you can bt^ a card ftom fitted En^^t^ (EO. Bc»c 
798, Canollton, Texas 7500^ support and credit card ordeis: 214492-202Z 8 
am to 11 pm central time, seven days a week) that does what Apple's standard 
card does, but has a few extra capabilities. First of all an ROB option can be added 
to the card later, vi^en and if you need it for $129 ($308 total- $9 more than the 
AppleColorCard). 

More importantly, however, the amount of memoiy on Applied Engineering's 
card, which is called RAMvrorks, can be increased at any time (in 64K and 256K 
inaements) up to 1 megabyte (],024li). Apple's card, on the otiier hand, cant 

expand. 

By expanding the amount of memory in your ^ple He you can turn it from a 
meek little machine built around 8^ear-old technology into an inaedible power- 



house that amazes everyone. Old-timers may not believe this reincarnation is 
possible, however, because of a m^jor problem extended memoiy cards for the 
Apple II have had in ttie past— there was precious little software around that 
actually used them. 

People who bought these cards expecting Applesoft to allow larger programs 
were always disappointed; Applesoft was designed for a maximum of 48K of RAM 
and isn't ever going to be able to use more than ^at unless someone rewrites it 
In £»t no high-level lai^uage for the Api^e 11 that I know of has built-in support 
for more than 128K of memoiy 

This leaves essratiaqf fDiir mgrs to take aibaiitage of an eiKteiHleil 

memoiy card. 

rirst you can write your own assembly language programs that use it This is 
pretty rare, but it happens. 

Less rare, but not by much, are commercial programs that look for extended 
memory and use it when it's available. A good example of existing software that 
does this is mgiCalc (sold by user ^oups under the names MCca/cand The 
Spread^eet), The reason this kind of sofh^are is rare is that extended memory * 
cards from difieient manufacturers are usually incompatible with each other, Up 
till now, no single manufistdurer has sold enoi^h cards to set a standard 

Third, you can use an extoided memoiy card as a RAMdIsk. This makes the 
card act like a veiy ^ disk (frhtt. Such drives have their IfanHs, hOM^ 
stored on a RANdisk can't sunive a power fiailure. RAMdisk users have to copy all 
the files they're working on to the RAMdisk after turning the computer on, and, if 
the files are changed, save them back to floppy before biming the computer off, 
An additional problon b that most commercial software, especially the copy 
protected kind, |»t)vides no way to connect or use a RANdisk, even when lots of 
RAM is available. On the other hand, a RAMdisk can be used to enhance the 
performance of high-level languages. One way to create a large Basic program is 
to break it into pieces, store the pieces on a RAMdisk, and use Basicsystem's 
CHAin command to switch among the pieces when necessary. If switching is kept 
to a minimum, the program will execute only slightly slower than normal, because 
RAMdisks are so fast This technique can also be used with DOS 3^, but the 
procedure for CHAining under DOS 3.3 is more complicated. 

The fourth way to use extended memory is to modify existing commercial 
solbA/are so that it recognizes and uses all of the memoiy available. Applied 
Engineering's RAMworks comes with a disk of modifications for App/eHforJts. It is 
this particular combination of AppleWorks, RANwoilts, and Applied Engineering's 
AppleWorks patches that suddenly make memory expansion on the Apple 11 a 
wonder to behold 

Uttindentaiid the power of this combinatiQii, you have to know a little 
vitmAMpfk^Hmks, /ppleWorks provides its users with a "desktop ' onto which 
files can be placed. These files can be spreadsheet files, word processor files, or 
data base files. Up to 12 files can be placed on the desktop at once. By using a 
built-in "clipboard ", data can be moved between files of the same type. Data can 
also be moved ft-om any kind of file into the word processor. But more importantly, 
when two files are on the desktop, a user can switch between them without having 
to waste time saving or loading either. If you've ever been working on a document 
with a word processor and needed to refer to numbers in a spreadsheet you know 
how time consuming switching data and programs can be. 

But with AppleWorks and RAMworks, the switch can be instantaneous. Here's a 
real example. Over the past few years, I've developed spreadsheet templates for 
the various income tax forms I have to file. This year I was able to load all these 
templates onto the AppleWorks desktop at once and switch between them 
instantly This gave me the ability to enter figures and fix mistakes in all reterant 
templates at the same time, rather than trying to remember the changes I'd made 
on little soaps of paper. This saved me hours of bewilderment 

Reviewers of ApptoWoiks have tranded to concentrate on what it can't do (that 
stand-akme packages can) rather than on the synergistic efiects of 
powerful programs available at tiie same time. I stilluseflie moieixiwerftil^pfite 
lifter for most word processing chores— but 1 write for a IMng, Each of Appfe- 
IM^'modules has plenty of capability for most of us and more than enough for 
tiierestofus. 

With a 64K ext^ded memoiy card in place, AppfeHMs has a 55K desktop. 
With a 128K card, the desktop increases to lOlK. 

The real power increase comes with a 256K RAMworks, however. At this point 
you not only have a 200K desktop, but the entire App/eWtorlcs program can be 
loaded onto the card as well. Start-up time increases under this option, but 
response time once the program is running is immediate. 

Applied Engineering sells its card with 256K of RAM already installed for $399. 
The top-of-the-iine card, with 1 megabyte of RAM, costs $U99. However, 
remember that when the Apple II was introduced in 1977, 16K RAM chips cost 
almost as much as 256K chips cost today Look for the price of 256K chips to 
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come down — the cost of filling the empty sockets on a RAMworks card vMl come 
down with it 

The latest version (3.4) of the RAMworks software also offers users the option of 
making three other changes to Apple)^rks. normally, if you choose to "let the 
new information replace the old" when saving an AppleWorks file, the old file is not 
actually deleted until the new file has been saved. Because of this feature, the 
largest file that can be saved on a floppy is 70K — one-half the capacity of the disk. 
By opting to delete this feature, you can store 140K files on a standard floppy. 

If this isn't enough, another possibility is to let the RAMworks software modify 
AppleWorks so that files can be larger than one disk. 

The third option available increases die number of records allowed in an 
ApfAeWorks data base file from the normal 1350 to 4,285. Using this option, a 1 
megabyte RAMworks, and three files, it is feasible to have 10 to 12 thousand 
records on the Apf^eWorks desktop at the same time. 

In addition to the AppleWorks modification package. Applied Engineering 
offers three otiier software packages that work with RAMworks, tmt tiiese tiiree 
cost extra. They include RAMdisk software for ProIX)S, DOS and Pascal; 
RAMdisk software forCP/M; and a VisiCalc lie expander (up to 437Kwitii Advanced 
VlslCalc and a 512tV RAMworks). People who have earlier versions of tiie Apple- 
Works modification package can get an update by sending in tiieir old disk and 
$10. 

If you own an Apple He all is not lost Applied Engineering has just announced a 
card that goes inside a lie (somehow) and that adds both CP/M capability and up 
to 512K of memory to that model. This card, which 1 haven't tested, comes with 
botii the RAMdisk and the AppleWorks modification software and costs $449 for 
the 256K version or $649 for die 512K version (or $159 for CP/M alone ~ Pascal 
freaks, add up die price of this card and the $69.95 that Borland International 
charges for its TurboPascal and compare it to the $250 that Apple charges for 
Apple Pascal 12. You'll find yet another place to both save money and get a higher- 
quality product). 

The technical details of the RAMworks card are that it has room for four 
banks of memory chips. TWo of these banks are on the main card and two are on a 
piggy-back card that plugs into the main one. Each bank contains sockets for 
eight RAM chips. 

People tend to get condised at tiiis point because it takes eight 64K chips to 
make 64K bytes of memoiy. The ' used to describe RAM chips is a countof bits 
on die chips. It takes eight bits to make a byte and eight chips to make a bank of 
RAM memoiy (d^?). The RAMworks card can use eitiier 64K or 256K chips, as 
long as you don't by to mix different sized chips in a single bank. 

Thus the minimum memoiy configuration is one 64K bank. This can be 
expanded to four 64K banks. Oryou can have one or more 256K banks and one or 
more 64K banks mixed togetiier. If you already have an extended memory card of 
some other type, you can pull the RAM chips off of it (they're probably tiie most 
expensive part of tfie card anyhow) and put tiiem on a RAMworks card. 

Once the RAMworks card is in use, it is invisible to software written for 46K or 
64K systems. Software tiiat looks for a 128K Apple will find RAMworks and can 
interact with it in exactiy the same way as with Apple's card. 

Prom a software standpoint the additional memory on a RAMworks card is 
organized as extra 64K auxiliary banks of memory. A program can select which 
64K bank should appear by writing Uie desired bank number (0 through 15) to 
address $C073 (49267). After the bank is selected, a program can use the built-in 
auxiliary memoiy softswitches on a lie to select the various options for reading 
ft-om or writing to the selected bank. Thus a program can transfer data between 
main memory and any of the auxiliary banks by itself or by using tiie Apple lie's 
built-in memory-move routines. Data transfers between diffierent 64K banks, 
however, must be done by using an intermediate move to main memory 

Bank zero contains the 80-column and double hi-res video pages. Video 
information is always dispiayedfrom bank zero of RAMworks, even if another 64K 
bank is active. Applied Engineering has applied for a patent on this feature. 
However, when storing information on the 80-column or double hi-res video 
pages, bank zero must be the active auxiliaiy bank, as usual. 

The address RAMworks uses for selecting memoiy banks also triggers the 
Apple 11 "paddle stobe", which is used to read the paddles. This means pro- 
grammers should always insert a 3 millisecond delay before trying to read tiie 
paddle/joystick position. This should be standard programming procedure any- 
how, since multiple paddle-reads witiiout a delay can create bad reads (for tiie 
details on this see tlibbting at the Game Paddle Port by Peter Baura in the 
October 1984 /Yii)We, page 100). 

Unfortunately, the contents of the RAMworks bank register can't be read. 
Programs must keep track of the current bank number. Applied Engineering 
recommends ttiat tills be done by storing tiie bank number in reserved locations 
inside each bank and suggests $frfO and $47B be used for tills. 



The bank register is automatically initialized as zero during power-up, but not 
after a reset This means tiiat programs tiiat use otiier banks should store a zero 
in Uie bank register after a reset Programs tiiat use interrupts must also install an 
interrupt handler in each bank of memory When an interrupt occurs on an Apple 
II, the microprocessor jumps to the address in the interrupt vector at $FFfL On a 
1 megabyte Apple, tfiere are 16 $rFrEs in auxiliary memory, plus 1 in ROM and 1 in 
RAM in main memory Thus interrupts get complicated, but they can still work if 
everything is thought out carefully 



Seeing red in RGB 

In nortii America, there are Uiree different technologies available for displaying 
Apple II screen output In tiiis article well examine each of ttiem, talk about tiieir 
advantages and disadvantages, and examine some technical details pro- 
grammers need to know to use Uie most expensive of the ttiree, RGB, witii double- 
resolution graphics. 

If yon afarady own a television set, tiie cheapest my to display what's on 
your Apple's mind is to use a device called an "RP Modulator. " This gadget takes 
tiie video signal coming out of your Apple and puts it on a "channel" so your TV 
can receive It After making all tiie connections, you can watch your Apple tiiinkby 
tuning in channel 3 or 4 or 33 or whatever. 

RF Modulators are available for all models of Apple 11. On the lie, the modulator 
plugs into the back-panel connector wiUi tiie color-TV icon. On other models the 
modulator usually installs inside tiie case and is wired to a special set of pins 
called the "Auxiliary Video Output Connector," Modulator prices vary from about 
$30 to about $60. 

The primary disadvantage of using an RF modulator is tiiat 80-column text is 
unreadable on a television set Even 40-column text is fiizzy on some sets. 
Advantages of this technology are a relatively low price, color displays {if you are 
using a color TV), and tiie ability to change channels and watch iaveme and 
Shirley reruns when you get discouraged with computing. With a lie and an RP 
modulator, you can also route your Apple's sounds tiirough the TVs speaker; the 
sound quality I Ve gotten has been disappointing, however. 

The composite monitor is the most widely used display technology 
among Apple II users. In the U.S., an "ordinary" composite monitor is one that 
accepts a video signal compatible with a standard known as HTSC (national 
Television Standards Committee). Outside Hortti America other standards, (CXIR, 
PAL, SECAM) are used. A major advantage of composite monitors is that tliey can 
be directly connected to tiie small round video connector found on the back of all 
Apple lis; no additional equipment is necessary. Composite monitors are avail- 
able in monochrome and ftilkolor versions. 

Monochrome monitors have two primary advantages. First they are relatively 
cheap— about $100 to about $250. Secondly they provide tile sharpest display 
available for work involving 80-column text Their primary disadvantage is that 
they cannot display full-color graphics. The fashionable display color for mono- 
chrome monitors appears to be amber this week, but green and plain old white 
are also popular. 

Full-color composite monitors do color graphics somewhat better than a color 
television. They have no other known advantages. They are expensive, 8<k:olumn 
text is bad, and you can't change the channel. 

The third available technology is RGB (red-green-blue). This is tiie only 
system tiiat allows botii full-color graphics and readable 80-column text on the 
same display screen. The price you pay for this technology, however, is high. An 
RGB monitor costs $400 to $600 and you also have to buy a special RGB adapter 
to plug into your Apple. 

The RGB adapter goes into the connector with tiie color-TV icon on the lie into 
the auxiliaiy slot on tiie He, or into slot 7 on a ll-Plus. If you are using an Apple 
memoiy card in the auxiliary slot of a He, you'll need to replace it to use RGBcolor. 
The RAMworks card discussed elsewhere in this letter can be adapted to provide 
RGB signals witii tiie addition of a special piggy-back card that can be added at 
anytime. 

{Actually if this is a piggy-back card, then the card for adding extra memory 
chips to RAMworks must be a piggy-stomach card, since it goes on the otiier side 
—they can both be used at the same time. The whole thing looks like a ham 
sandwich. You can also get a card into slot 1 but the fit is very tight— the cards 
touch each other. So maybe you better make that a grilled ham sandwich.) 

Witii Applied Engineering's RGB option for RAMworks, incidentally tiie color of 
text displays is switch selectable. You can make your expensive color monitor 
appear to be a white, green, amtter, or blue monochrome monitor when working 
witti text only However, 80-column RGB text is not as sharp as v^t monochrome 
monitor users are used to. 
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The biggest surprise of using RGB with an Apple II is that double- 
resolution graphics dont ahvays work. While standard single-resolution 
Apple graphics always come in loud and clear on an RGB system, double- 
resolution graphics don't. In order to see anything when double-resolution 
graphics are displayed, you must have both an RGB card that supports double- 
resolution graphics and software that turns on the RGB card's double-resolution 
feature. 

And yes, don't fool yourself, there are RGB cards around that don't support 
double-resolution graphics and there are commercially available double- 
resolution graphics programs that don't turn on RGB. So there you go, Bo-Bo; you 
just spent $800 on an RGB system and sometimes it doesn't even do what a $250 
color television can do. 

One of the programs that does support RGB double-resolution is Beagle 
Graphics. Mark Simonsen wrote Beagle Graphics, and he says Apple-compatible 
RGB cards are supposed to support at least three modes of double-high- 
resolution. The monochrome mode has a resolution of 560 x 192 pixels (one bit 
per pixel) and no colors; the coformode has a resolution of 140 x 192 pixels {four 
bits per pixel} with 16 colors; and the mixed mode combines these two. 

(In mixed mode, the RGB card looks at the high bit of each byte to determine 
whether it should decipher the bits in that byte as color (high bit on) or mono- 
chrome (high bit off). In the other double-resolution modes the high bit of each 
byte is ignored (it doesn't even matter whether you're talking RGB or riTSC 
composite). In standard single-resolution graphics, of course, the high bit is a 
color-selection bit If you don't know what all this means, don't worry about it) 

Turning the various RGB modes on and off is a matter of peeking or poking at 
softswitches. The softswitches used to control RGB are the 80-column off and on 
switches at 49164 and 49165 {$COOC-COOD) and the single-resolution off and on 
switches at 49246 and 49247 ($C05E-C05F; these also control annunciator 3). 
These four switches are accessed in different sequences to turn on different RGB 
double-resolution display modes. The control sequences should be executed 
each time double-high-resolution graphics are turned on. Execution should 
occur a/ter the standard switches for graphics ($C052, $C057, $C050) have been 
thrown. 

Double-high-resolution programmers note carefully: If you want your 
software to work on RGB systems, you must use the following control 
sequences to turn on double-high-resolution: 



monochrome 

B0COL off 
5NGL.RE5 off 
SNGL.RES an 
5NGL.RE5 off 
SNGL.RES on 

80CDL on 
SNGL.RES dff 



color 

80CQL on 
SNGL.RES off 
SNGL.RES on 
SNGL.RES off 
SNGL.RES on 
SNGL.RES off 



mixed 

B0COL off 
SNGL.RES off 
SNGL.RES on 

B0CQL on 
SNGL.RES off 
SNGL.RES on 
SNGL.RES off 



In addition to these three modes, some RGB cards may have additional modes. 



Sixteen-color 40-column text (using the display page in auxiliary memory for 
color infomation) and a 160 x 192 mode that has two 16-color pixels per byte (and 
a straightforward screen-mapping) are two possibilities that have been men- 
tioned, but not yet documented. 

Lutus puts edHor in public domain 

Paul Lutus, author of Apple Writer, has placed a rudimentary version of this 
widely-used word processor in the public domain. The new program is ProDOS- 
tyased and is called Freewriter. It was recently distributed to Apple user groups by 
the International Apple Corps on lAC disk 43; many groups have released or are 
releasing /1AC.43 to their members as a disk of the month. 

Freewriter's appearance and command structure are very similar to those of 
Apple Writer. It uses standard ProDOS text files. If you've been looking for a cheap 
way to peep into text files while using ProDOS, this may be it 

Like Apple Writer, fy-eeiyrifer has a status line at the top of the screen that shows ' 
how much memory has been used (maximum file size is a little more than 30,000 
characters). It uses an 80-column display when run on an Apple He with 80- 
column card or on an Apple lie with the 80/40 switch in the down position. It uses 
a 40-column display otherwise. 

Commands are included to load and save full or partial files, to find and replace, 
to jump to the beginning or end of a file, to erase a file from memory, and to 
embed control characters within a file. The right and left: arrows can be, used in 
cor\junction witii the open-apple key to delete characters and recover them. 
Freewriter has one command heretofore available only in the newest version of 
Apple Writer, it allows you to select a page widUi from 1 to 240 characters— if a 
width wider than the display saeen is selected, horizontal scrolling keeps the 
cursor in view, /^eewriferalso has a built-in tutor. 

But that's it. Here are some of the things Freewriter doesn't have that Apple 
IVriierdoes: case-change mode; find caniage returns or wildcards; the glossary 
(macro) frinction; tabbing; disk commands {Freewriter has only load, save, and 
catalog); printing (wait! I'll explain in a minute); word processing language; 
everything that appears on Apple Writer's additional functions menu (control-Q) 
except quit" replace characters mode; delete word and delete line; and tiie split- 
screen function. 

While fyecwriferincludes no facility for printing files, a separate Lutus freeware 
program on /IAC.43, Uiis one written in Basic and called PRirfrCR, slowly prints 
text files created with Freewriter (or any other program, for that matter). It allows 
you to enter a page header if desired (including page number), and to choose 
margins and page lengtii. (/IAC.43 also includes several other free Lutus pro- 
grams written in Basic for your perusal and enjoyment) 

fyeewrtter will boot and run on any Apple having at least 64K of memory, but 
special problems occur on older Apples because they lack some necessary keys. 
In particular, deletion (which wasn't very good to start witii) becomes impossible, 
since there is no delete key and no open-apple key Button zero on a joystick or 



The only way to write any but the most simple program is with a word 




e 0S=CHfi$(4) : POKE 33,33 : INPUT TILE NfWE? : PRINT Dj;"tPEM";FS 

. PfiiNT DsrciosE:" 




V-SS : PRINT 0$:'mETE-;F$ : PRINT D$.rQPEN";r* : PRINT 
: LIST U : PRINT D*rCLOSE";Ft : TEXT : END 



Once you have your program saved, get out of your word processor and 




ifcttS^ a ka^t one Return, more doesn't hurt here), so that the Basic 




Af^le rnUer or Freewfiter. To get it into Applemrks. don't take the natural 



the Word Processor;' Another menu will appear. Select' 

dyou'HbeieacTjrtocdit 
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game paddle can be used to take the place of the open-apple key, but it's no fun. 

Other problems on older Apple lis include the impossibility of entering lower- 
case letters without an enhanced keyboard, a tutorial that is unreadable without a 
lower-case chip, and the lack of up and down arrow keys (but you can use control- 
K and confrol-J instead). 

Assembly language programmers should be particularly interested in this 
disk for two reasons. In addition to FreewritcK /IAC.43 also includes the first 14 of 
the 16 ProDOS technical notes that have been released by Apple. These are 
additions to and amplifications of the material in the ProDOS Technical Reference 
ManimL If you are interested in writing assembly language programs that run 
under ProDOS, this material is essential. 

The second reason assembly language programmers might want tiiis disk is to 
disassemble Freewnter I cut my assembly language teetii by taking apart Lutus's 
Apple Writer 10 several years ago. You can learn a lot by studing a master like 
Lutus. (In fact if you'd like to watch a master disassemble a master, get a copy of 
Call -ARP.LE. In Depth #4, All About Applewriter He, by Don Lancaster. The book 
takes you through a step by step disassembly of Apple Writer lie.) 

What I learned at MACUL 

1 spent a couple days near the end of March in Detroit I was giving speeches 
about the Apple II at Uie annual meeting of the Michigan Association for Compu- 
ter Users in Learning, 

It was enlightening to meet people who are using Apples in education and to 
hear about their trials and successes. And when not giving speeches myself, 1 was 
able to sneak into some of the otiier sessions and pick up some interesting 
tidbits. 

One of the speakers was Sue Talley whose speech was called "Apple's Commit- 
ment to Education. " T&lley is one of Apple's marketing wizards; she specializes in 
the education market She faced some tough questions fi^om the audience about 
Apple's commitment to keeping future models in tiie Apple II family compatible 
with what schools have today 

She responded tiiat computer models change every two to three years while 
educational institutions tend to update technology on a much slower cycle— 
every ten years or so. Thus, "changing technology will cause you some problems," 
she admitted. But tiie primary market for the Apple H Is in schools, and Apple 
currentiy holds over half of that market Consequentiy, Apple is also committed to 
compatibility. 

"We realize a lot you have software on 5-1/4 inch disks. We won't leave you 
behind as we change technology," Talley said. 

Talley also confirmed that Apple has an Apple 11 version of its Apple Talk 
network under development 

MACUL's keynote speaker was David Thomberg of Stanford University. 
Thornt)erg invented the Koala Pad and tiie Muppet Learning Keys, and has written 
a bunch of books on personal computing. Thomberg also gave several sessions 
on Logo that I attended. 

His Logo sessions were very informative, and confirmed my suspicions that tiie 
language goes Beyond Turtle Graphics (tiie titie of a newThornberg book due out 
this summer). His keynote speech, on the otiier hand, struck a few sour notes 
when he attacked Basic and insisted that it should be dropped from school 
curricula. The standing ovation he got however, means a lot of people in 
education agree witii him. I don't 

The point that Thomberg makes is Uiat Oiere are better languages for teaching 
students organized problem solving than Basic. My point is that while learning 
organized problem solving is important it is not a star that all computer 
education must revolve around. 

People have got to get away from the idea that there is a single language that is 
"best " for all situations. Basic, for example, is not well suited for large institutional 
programs written by several different people. Pascal, on the other hand, is not well 
suited for the short and sweet persona/ programs typical of the software compu- 
ter users write for themselves. Neither Basic nor Pascal is good for mass market 
commercial sofbvare, which is almost all written in assembly language. And 
assembly language stinks for any program that won't be mn at least 10,000 times 
because it takes so long to write. 

And there isn't any computer language that gives tiie average mugwump on tiie 
street tiie number crunching power of a good spreadsheet program, or the data 
storage power of a good data base program. 

Thomberg is well intentioned, but he lives in an ivory tower totally concerned 
with developing tiie abstract thinking ability of students. I can appreciate that the 
worid needs abstract thinkers. But that's not all it needs. Besides, who learns the 
importance of good organization any better than someone who attempts to write 
a long program in Basic? 



It isn't impossible to write structured Applesoft programs, as was amply 
demonstrated by JoAnne McVicar and Larry Dove, teachers from the Livonia, 
Michigan public schools. They did a session on the objectives and course content 
of tiie Livonia Public Schools' introductory programming course for high school 
students. 

The course is called "Computer Math 1 ". The course description goes like this, 
"Computer Matii 1 introduces students to concepts designed to help them 
become computer literate. Students will use tiie computer to solve problems in 
matiiematics appropriate to ttieir individual mathematical experience. Students 
will learn the Basic language using a shoictured approach to programming" The 
course was developed by a group of teachers from different Livonia high schools. 
Besides McVicar and Dove the group included Dan Kinczkowski, Ed Segowski, 
and Jim Winebrenner, who is tiie distiict's computer coordinator. 

At the beginning of the school year. Computer Math 1 students are given a disk 
with a skeleton Applesoft program on it Here's what tiie program looks like: 



200 REM 

210 REM DICTIDNflRY 
220 REM 



1000 REM 

1010 REM MAIN BODY 
1020 REM *********** 



2000 REM ************** 
2010 REM INSTRUCTIONS 
2020 REM ************** 

3000 REM ************ 
3010 REM INITIALIZE 
3020 REM VARIABLES 
3030 REM ************ 

4000 REM «*«**»*««» 
4010 REM HEADINGS 
402^1 REM ********** 



5000 REM *»***«« 
5010 REM INPUT 
5020 REM ******* 

6000 REM »*»««*»***»* 

601f REM PROCESSING 
G020 REM »«»*»*»*»«** 



7000 REM ******** 
7010 REM OUTPUT 
7020 REM ******** 

B000 REM ********** 
8010 REM GRAPHICS 
B020 REM ********** 



9000 REM ****** 
9010 REM DATA 
9020 REM ****** 



10000 REM *********** 
10010 REM SPACE BAR 
10020 REM *********** 

15000 REM ********* 
15010 REM SORTING 
1S020 REM ********* 

20000 REM **«*»*< 
20010 REM MUSIC 
20020 REM ******* 

65535 REM student's 

naine emb added 
here 



Each project a student does has to use this skeleton. Many projects, particularly 
early ones, won't use the whole thing; in that case the student can delete 
unneeded headings. One thing most students have trouble deleting, however, is 
the last line of the program, formally Applesoft doesn't allow line numbers above 
63999. McVicar and Dove said they learned this trick from the "Bigliner" program 
on the Beagle Bros Utility City disk. 

Students also receive a style sheet that explains in greater detail what finished 
programs should look like. All programs are to begin with an "identification 
block" (there's no heading for this, since it is itself the "heading" for the whole 
program) at line 100. This block uses REM statements to identify the titie and 
author of the program, the date it was last revised, and the name and hour of the 
class it was written for. 

The dictionary that follows line 200 is a listing of all the variables used in the 
program and what tiiey are for. If the program uses functions, tiiey must also be 
defined here. 

The main body directs the flow of the program, and usually consists almost 
entirely of GOSUBS. 

The instructions section is for code tiiat displays instructions to the program's 
user. All programs are screen-oriented, so these insh-uctions must always appear 
on the screen. Skills such as centering, preventing screen scrolling, and other 
tricks for formatting output are taught as a part of the course. 

The mitia/iza(/on section is used to dimension arrays, define functions, and 
initialize all variables. The headings section is for placing "permanent' instruc- 
tions and data on the input and output screens. 

The input section is for IPiPUT and READ statements, for checking the validity of 
input data, and for loading files from disk. The processing section is for doing 
calculations and file manipulations. The output section is for placing answers on 
the screen and for saving files to disk. 

The graphics section is for code that displays graphics. The data section is for 
all DATA statements. The space l)af section is for a set of subroutines, provided by 
the teachers when necessary, that prevent scrolling, provide for screen and 
graphic dumps to a printer, and include a quit option. The sort and music 
sections are also for subroutines usually provided by tiie teachers. Line numbers 
after 30000 can be used by students to generate any other subroutines needed 
as tiie course develops, 
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Enhanced lie and AE Pro 

I have installed the new enhanced lie chips and 
have been very satisfied. I know others will not have 
my experience, but ALL of the standard software I use 
daily works just fine with the new chips, so compatibil- 
ity has not been a problem for me. I also have a lie 
and have had no compatibility problems with it 
either 

Regarding the use of ASCII Express version 4.20 
with the new chips, I have had no trouble using it with 
either the enhanced lie or the lie. However, after 
installing the new chips I did have to run the inSTALL 
program and change my local console selection 
(select "L" from the main INSTALL menu). The auto 
selection under console types (number 0) is what I 
chose. You might try changing the console type to see 
if that eliminates your problem. I have been using AE 
Fro on tiie 11c for six months and on the enhanced lie 
for two weeks and it works great That does not 
however, mean yours will work tiie same as mine (as 
we well know). 

Although I like the new chips, I really doubt that 
most people will want to run out and get the upgrade. 
Unless your application requires the new chips, you 
probably don't need tiiem— although there is a sig- 
nificant improvement in SOcolumn mode. 

Steve Muncy 
Dallas, Texas 

Amazing. That works on mine, too. OK folks, 
Open-Apple's He now uses the enhanced ROMs full- 
time. 

Dealers bend rules 

I was lucky enough to get a lie enhancement kit 
from a dealer who let me install tiie chips myself, so I 
still have the old chips. 1 wouldn't buy it without the 
right to keep the old chips, even if the dealer insisted 
on installing tiiem himself. James Patton 

Littieton,Colo. 

Many dealers are apparently willing to sell the kit 
(at the ^installed" price) without installing it even 
though Apple has asked them not to. I highly recom- 
mend you buy the kit this way so that you can be 
sure you have your old chips. The kit comes with 
installation instructions. You'll need a small flat- 
blade screwdriver to slip under the old chips so you 
can gently pry them out Be careful not to get a chip 's 
pins bent out of line, not to put a chip in backwards, 
and not to zap a chip with static electricity and you 
should have no trouble. 

Whatever you do, don't pay a dealer extra to install 
the chips. Apple's suggested retail price is supposed 
to include installation. 



Lower case for DOS 3.3 

I enjoyed your article on the lie enhancement 
ROMs in the April issue. As you mentioned, it's nice to 
have Applesoft and the Monitor accept lower case 
input which of course also applies to FroDOS. Unfor- 
tunately DOS 3.3 still does not accept lower case. 1 
got tired of getting SYTiTAX ERRORS every time I 
forgot to press the GVPS LOCK key, so 1 worked out a 
modification to DOS 3.3 to make it accept lower case. 
Here it is in the form of an Applesoft program: 

10 REM Louer case for DOS 3.3 (uses IBCDF) 
20 FOR 1=0 TO IB : READ J : POKE 48351+ I, J : NEXT 
30 POKE 413Gg,7G : POKE 413^0,223 : POKE 41371,188 
40 OflTR 201,224,144,2,41.223,201,141,240,6,232,142, 
33,170,201,172,96 

1 suggest booting witii a DOS 3,3 System Master 
disk to be sure you have a clean copy of DOS before 
running tills program. 

J. Morris Prosser 
Pebble Beach, Calif. 

Your program sticks the lower-case conversion 
routine inside a normally empty space inside DOS at 
$BCDF. Many other programs have been designed to 
use that space as well 

I too, am tired of CAPS LOCK, but I use $BCDFfor 
something else. 1 looked around for some other 
place to stick your routine, but there aren't any left 
that haven't already been used for something. Then I 
decided to gulp great big and get rid of something 
close to my heart that I actually haven't used in a 
long time. Integer Basic. Mere's a version of your 
routine that should work with even highlymodlfied 
copies of DOS 5.5: 

10 REM Lauer case for DOS 3.3 (deletes Integer Basic) 

15 POKE 40268,121 : REM make INT do FP 
20 FOR 1=0 TO 3 : REfiD J : POKE 40290+ I, J : NEXT 
130 POKE 41374,32 : POKE 41375,98 : POKE 41376,157 
40 DfiTfl 142, 93, 170, 201,224, 144, 2, 41, 223, 9& 

Of course, there are other ways to solve this prob- 
lem, too. . . 

Old bugeyes writes 

When 1 read my Baste Programming with ProDOS 
manual, 1 saw two things that almost convinced me to 
abandon DOS 3.3... 

1 Page 154 and 206: ProDOS makes an HQR or 
HQR2 command protect tiie hi-res pages so your 
Applesoft program and variables won't overwrite 
them. 

2. Page 207: ProDOS lets Applesofts inPUT state- 
ment accept anytiiing. Including commas and 
colons. 

Apparentiy the writer of this manual has been sit- 
ting on his head too long. Do you have any inside info 
aboutthis? 

Incidentally a recent reader asked you about how 
to make his He accept lower case keyboard com- 
mands. One solution, as you stated, is a He enhance- 
ment kit Another solution, with many more benefits, 
isQPLE. 

While we're on Uie subject by this apparentiy illegal 
statement on your lie or enhanced lie: 

print 2-'2 

as it turns out is a lower case "^".) 

Bert Kersey 
Beagle Bros, Inc. 

The two ProDOS features you mention were 
includedtn early versions of Basicsystem, but were 



removed because of intractable bugs. Somehow, 
they didn't get removed from the manual however. 
Speaking of bugs,... 

Wrong number 

The phone number listed for Sunset Software last 
month (page 30) isn't right Do you have a correction? 

Bob Leedom 
Glenwood, Md. 

Indeed, I seem to have copied the area code down 
wrong. H should be 2t5-47&0245. 

HUMANTBCT errors 

I have just installed the enhancement on my He 
and on entering your HUMATiTEXT DEMO from tiie 
April issue (page 27) I kept getting errors in lines 110 
and 120. 1 changed them to read as follows: 

110 M$=CHR$(27) : Ti=CHR$(15] : MT$=M$+T$ 
120 NS=CHRJ(24) : RI=CHR$(14) : RNI=N$+R$ 

Even placing a semicolon at tiie end of tiie lines 
caused an error. Why? 

By tiie way I was not able to configure tiie Sider with 
a Microsoft lie Premium card in slot 3. CP/M will not 
work and I've seen some strange sights with Apple 
Pascal. 

Warren L Posey 
Santa Ana, Calif. 

/ found those same bugs in the tlUMAFiTEXTDEMO 
when I tested it but somehow the corrections never 
got into the file I sent to the printer, here is how the 
lines appeared in the April issue: 

110 MTl=CHR$(27);CHRJUS)-; : REM turn on mousetext 
120 NRI=CHR$(24);CHR$(14); : REM turn off mousetext 

The semicolons are the problem. The first semi- 
colon in each line should be a plus sign; the second 
semicolon in each line should be removed. This is a 
common error, at least around here. The confusion 
stems from the use of semicolons in PRIHT state- 
ments. If these lines said PHim instead ofMT^ and 
/YK$=, the semicolons would be correct. Outside of 
PRIFiT statements, however, you must connect 
strings with the plus sign not with the semicolon. 
(Alternatively, plus signs are legal for connecUng 
strings inside PRIIiT statements, but mn:t be used at 
the end to suppress a carriage return.) 

I haven't tested the Sider with either CP/M or Pas- 
cal Yours is the first report of problems with either 
one that I've heard, however, and I've seen many 
reviews lately. The Sider manual does say you 
should put the CP/M card in slot 4. 

To flip or not to flip 

I have a question for you that might be of interest 
to otiier readers: Is the practice of flipping over a 
floppy disk and using tiie otiier side as an economy 
measure a good habit? 

Benjamin Day 
San Marino, Calif. 

/ u;as hoping nobody would ever ask. fio matter 
how I answer, half of you will argue that I'm dead 
wrong. At least you didn't ask about copy protection. 

I've been using the flip side of disks for a couple of 
years now. I haven't experienced any problems. 
Over the course of time and many, many disks I've 
run into a few bad ones, but they were bad right out 
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of the box and they were bad on the side you were 
supposed to use. It appears to me that if one side 
works, the other side will work too. 

[got started at this by stealing a one-hole paper 
punch out of my daughter's pencil box. All you have 
to do is punch a notch where there ought to be one 
and put the disk in the drive upside down. 

There are a few theoreUcsd reasons why this 
should cause problems. I think that the reason it 
doesn't is that disks fill up with data long before the 
problems start. Estimate how many hours your 
most-used disk has actually spent spinning inside a 
drive. I don't think I have a disk that has spun for 
more than a couple hours. The kinds of programs I 
use always load a whole file into memory in a few 
seconds and save them back in a few seconds. 

If you have a program that really makes disks spin 
—the kind of program that works with disk-based 
data rather than data loaded into memory —it might 
be better not to flip the disks you use with that 
program. Otherwise, I can 't see any problem. 

Seeing as printers see 

I neglected to include a joke on my subscription 
postcard, so here: 

"How many programmers does it take to change a 
lightbulh?" 

"None, that's a hardware problem. " 

Here's a brief note about the discovery of an undoc- 
umented feature of Apple's Imagewriter printer. The 
manual describes a printer selftest triggered by hold- 
ing in the "form feed" button while powering up. What 
is not described is the hexadecimal dump feature. If 
one holds in the "line feed" button while powering up, 
the printer will will print the hexadecimal codes for all 
characters it receives instead of doing normal print- 
ing. This feature is useful for debugging sequences of 
printer control codes, etc 

Incidentally, this is a standard feature of Epson FX 
printers and C. Itoh 8510 printers. The fact that the 
Imagewriter is a C. Itoh with modified firmware 
prompted me to by this out 

Bernard Goodman 
Cambridge, Mass. 

/ immediately tried your tip on an Apple Dot Matrix 
Printer and an Apple Scribe and it works on both of 
those, too. (On the Scribe you have to hold in on 
select" while powering up because '7me feed" and 
form feed" are the same, self-test generating, 
button.) 

1 can think of several uses for this feature in addi- 
tion to debugging printer control sequences, flow 
about using it to figure out the codes graphic dump 
programs are sending to a printer? With a little work, 
you could even put a serial printer where a serial 
modem is supposed to be and debug modem- 
command sequences. 

Text file splitter 

I've got an early word processor {Magic Window //) 
vdiich has the drawback of not being able to read a 
text file that is larger than memory. Because of this, 
when I create large text files (log^ng from a data- 
base), I can only view the first 12 pages, or so. My 
question is twofold; first is there a way to "split " a text 
file into more managable bytes? Second, if 1 happen 
to shell out for a Z-80 board and start running XMO- 
DEM for file transfer, does using that protocol also 
create text files which you then EXEC, or does it create 
some other type of file? 

Maybe the whole problem is my word processing 



program and I should just buy (ouch!) a new one with 
better features? g.,,^^^^ 

BBZ618 

Using the CP/M program XMODEM for file transfer 
will get you a bunch of CP/M files. You'll have to 
convert the CP/M files to DOS 3.5 before you can 
EXEC them. Most CP/M cards come with a disk utility 
that will do this. 

Here's a simple program that will (very slowly) 
split a text file into more managable pieces: 

10 REM *«* TEXT FILE SPLITTER «** 
100 Ot=CHR$(4] 

110 NFL=5000 : REM new file length, in bytes 
120 IF PEEK{97B)=157 THEN DQ5=3.3 : GOTO 200 
130 IF PEEI<( 978)0190 THEN PRINT 

"fiCTIVE DOS NOT RECOGNIZED." ; END 

200 HOUE : VTFIB 10 

210 PRINT "THIS PRGGRfln SPLITS LONG TEXT FILES" 
220 PRINT " INTO SMALLER PIECES. WHRT'S THE" 
230 PRINT " NAME OF THE TEXT FILE VQU WftNT* 
240 PRINT " TO SPLIT"?" 
250 PRINT 
260 INPUT F$ 

270 If LEN(F$)=0 THEN END 

300 PRINT D$;"OPEN";FS 

310 QNERR GOTO 500 

320 PRINT : PRINT 

330 PRINT "OK. NOW THIS WILL ^RKE SOME TIME..." 

340 PRINT " (ABOUT 20 SECONDS PER SECTOR]" 

350 PRINT 

400 FOR N=l TO 100 

410 : PRINT "NOW WORKING ON ";F$;".";N 

420 : PRINT D$; "OPEN";F$;". ";N 

430 : FOR 1=1 TO NFL 

435 : : IF D0S=3.3 THEN POKE 43602,0 

440 : : PRINT 0$;"REflD";F$ 

445 : : GET fl$ 

450 : : IF D05=3.3 THEN POKE 43602,0 

455 : : PRINT DS; "WRITE";F$;". ";N 

4G0 : : PRINT fli; 

470 : NEXT I 

475 : IF D0S=3.3 THEN POKE 43602,0 

480 : PRINT D$;"CLD5E";F$; ";N 

490 NEXT N 

500 PRINT Df ; "CLOSE" 

510 IF PEEK (222) = 5 THEN 530 

520 PRINT "ERROR PEEK(222];" IN LINE: 

PEEK ( 21 B] + PEEK ( 219 )«256 
530 POKE 216,0 : END 

Peel free to change the value offiPL in line 110 to 
whatever is suitable for your word processor. This 
program doesn 't check the contents of the file, it Just 
splits after the amount of characters you specify 
with an have been processed, so you can expect the 
splits to come in mid-sentence or mid-program line. 
You should be able to use your word proce^or to fix 
such stuff, however. 

Be prepared to go watch TV or put your kids to bed 
while this program is running. It takes about 20 
seconds per sector. Your computer will appear to be 
lodced up for most of that 20 seconds, but then your 
disk drive will come on to reassure you everything is 
working fine. 

ThePOm45602,0inttnes455and450isa^rute 
force carriage return" for DOS 3.5. notice that the 
POR loop causes the READ command in line 440 to 
follow the PRimin line 460. But the PRimends with 
a return-suppressing semicolon. Uncle DOS will not 
respond to tite READ command unless a return pre- 
ceeds it But if you print a return, it will be written to 



the new file (we would then have a return after every 
character). The forceful, decisive way to get around 
this problem is to cheat and reset the carriage-return 
fiag inside DOS by hand. This is what the POf^does. 

Likewise, the WRITE command in line 455 will 
never be recognized unless it is preceeded by a 
return because of the GET in line 445. (DOS com- 
mands always cause trouble after GET.) And the 
CLOSE command in line 480 needs a returnless 
return, as well 

The POKE 216,0 in line 530 simply turns off the 
OHERRGOTO. 



POKE 1403 problems 

I've discovered a bug involving the POKE 1405 
statement to position the cursor horizontally on the 
80-column lie, iPOliE 1403,X-1 does what hTAB X is 
supposed to do but doesn't on the original He.) For 
some unknown mystic reason, the first (and only the 
first) POhE 1403 after a DOS command, including 
PR#3, is ignored. If you know why this is or how to 
avoid it I'd enjoy reading about it 

My own solution is to do a dummy VTAB Y : PO/t£ 
1405,X to an unused screen location after each DOS 
operation. Clumsy, but It works. 

Mike Fredericks 
Littleton, Colo. 

Thanks for pointing this out Lots of people report 
trouble withVTAb, HTAB, andPOKE 1403. Maybe this 
is the primary problem. 

i don't know why, but another solution seems to 
be to PRIHT a return after every DOS command, for 
example, PRINT D$;'?R^3" : PRIPiT 

Changes coming to $C020 

The Apple II Group is seeking ways to expand the 
capabilities of our Apple II line. We would like to do 
this with a minimum of impact on existing products. 
We have determined that our future needs will require 
that we change the function of a series of soft 
switches. In the past the locations $C020 to $C02F 
(only $C020 was documented) were used for writing 
to the cassette port We have decided that the ftinc- 
tions of these locations need to change. We are letting 
you know of these changes now so that you can make 
needed changes to your software as part of your 
normal product updates. 

In the future, if you read from or write to these 
locations the current ROM configuration may be 
banked out This means the loss of Applesoft, the 
Monitor ROM and 80-column ROM. It is very impor- 
tant then that your products stop using these 
locations. 

Very little software uses the cassette port to actually 
mitB to the cassette. However, some software does 
write to or read from this port as a way of maintaining 
program speed when sound is turned off. In these 
cases sound is turned off by redirecting the poke to 
the speaker toggle to a poke to the cassette port 
Such programs would have to be changed to poke to 
an internal location or a known "safe" ROM or RAM 
location. 

Apple II Technical Support Group 
Cupertino, Calif 

By incrementing the high byte of speaker address 
you would make it point to $C150, an address within 
the ROM space of the card in slot 1 — one of the few 
memory areas that is always guaranteed to be 
"safe." 
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ProDOS bugs 



Here are some bugs that have been discovered in 
ProDOS that you might want to mention to your 
readers: 

1 In Basicsystem H if you BSAVE over an existing 
file the old load address and length are retained. I 
have reverted to 10, which does not have this prob- 
lem, but use the PRODOS m kernel. 

2. COIWERT applied to ProDOS - >DOS 3.3 on a file 
requiring more than one track/sector list (i.e. a file 
more than 61 blocks long) does not properly set up 
die track/sector list link or offset to subsequent 
track/sector lists. It takes a knowledgeable person 
and a disk zap to make such a file readable. 

Glen Bredon 
Princeton, H J. 

A reprtsenMm of Apple's Technical Support 
Group says the BSAVE prohlem is a true bug that will 
be fixed soon. Apparently there are also a couple of 
very exotic bugs in Basicsystem 11 that Apple's 
programmers would like to figure out and fix before 
putting out another release. You can overcome the 
BSAVE problem for now by deleting a binary file 
before saving— much as is done with text files. 

The COJWEKF problem is quite interesting. Com- 
bine it with the problem described in the next letter 
relating to the Uc System VtHities and you'll find 
there is currently no way to convert long text files 
fromFroDOStoDOS5.3. 

Mousetext apologist surfaces 

Dawgonnit with all the neat stuff in your newsletter, 
it's almost impossible not to write back with a few 
thousand or so comments. 

Perhaps 1 can add to the rodent discussion. Maybe 
the reason Apple put the mousetext characters 
where they did was so that assembly language pro- 
grammers who desired to store inverse characters 
directly on the screen could use the original inverse 
capital set in the $0-$lF range. This retains compati- 
bility with older Apples. Looking at it this way, the 
alternate character set replaces flashing characters 
with two sets of special characters, mouset^t at $40- 
$5r and inverse lower-case at $60-$7F. 

Keep in mind that the ASCII character set and the 
screen display character set are two independent and 
unrelated (execpt by sequence) groups of characters. 
And just for fiin, note that the two groups of "normal" 
caps in the screen display set are not the same. 
Those (control) characters in the $80-$9F range can- 
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not be fraced over using the arrow key POKE 
1025^28 and see! 

There are substantial differences between the 
enhanced He Monitor and the lie Monitor. The ability 
to enter ASCII characters using the apostrophe is 
great as is the mini-assembler for quick and dirty 
stuff. For those who may be interested, Apple has 
published identity bytes that can be checked to deter- 
mine which Monitor (and thus which machine) a 
program is running on, as shown in the following 
table: 

$FBB3 $FBC0 IFBIE 
Apple II 38 
Apple II-Plus Efi RD 

Apple III (in emulation mode] Elfl 8R 
Apple lie (original) 0G Efl 

Apple lie (enhanced) 0G E0 

Apple lie 0G 00 



Open-Apple is a trademark of Open-Apple newsletter, Apple 
Computer and Open-Apple are two different, unrelated, inde- 
pendent companies that wish everyone in the world had an 
Apple II. 



The Apple lie System Utilities disk is really el-neato; 
it does everything that FILER and COfWERT should, 
but don't do. You don't have to tell it volume names or 
identify a disk as 3,3 or ProDOS, etc Unfortunately, it 
has a couple of major bugs. Prom ProDOS to DOS, it 
will fill all sectors of a text file after the 46th with 
garbage instead of data, and from 3.3 to ProDOS, a 
long binary file will cause an unrecoverable system 
crash. 

Val Golding 
El Cajon, Calif. 

You make a good point about mousetext, but in the 
wisdom of hindsight I think Apple's wizards should 
have put it in the $80'$9F range where the useless 
normal Ciq>itals are. Your point about not being able 
to trace over that range would even be an advantage, 
since it makes no sense to trace over mousetext 
characters anyhow. 

Lam a'la Ruth 

In February (page 12) you showed readers how to 
use the Lam technique for entering Monitor com- 
mands from within Basic programs. Some time ago I 
wrote a Mockingboard speech editor in which 1 
wanted to enter strings of phonemes in the form of 
hexadecimal numbers. I planned to use the Lam 
routine to put the numbers into memory. However, 
repetitious use of Lam to handle lengthy Monitor 
commands turned into a serious drawback because 
of die routine's slow execution speed. 

The routine's sluggishness comes from its use of 
the MID$ function to extract characters from C$, one 
at a time, and poke them into the keyboard input 
buffer. Applesoft string operations are notoriously 
slow, and including them in a loop is one of the best 
ways I've found to waste time. 

I circumvented this problem by using the normal 
Applesoft version of the Lam routine to create a 
machine language version of itself. This way the slow 
Lam is executed only once, and all subsequent Lam 
requirements are handled by Lam a'la Ruth. The * 
speed improvement is phenomenal! 

The C$ string in the following program creates Lam 
a'la Ruth. It uses Monitor commands to install a 
machine language routine at $300 and to connect 
the routine to the Ampersand hook. After C$ has 
been installed using the standard Lam technique 
(line 110), tills program installs it a second time using 
the new technique (line 130). Beeps will give you a 
clear idea of the speed improvemenL 

10 REM »«* LRM fl'Lfl RUTH 
100 BELL$=CHR$ (7] 



110 C$="300:A5 71 4B 
AB fl5 84 
72 20 04 
0B d3 B0 
00 91 71 
85 71 60 



AS 72 4B 
85 AC A9 
E5 m 00 
99 00 02 
B4 48 20 
N 3F5:4C 



20 E3 OF A5 83 85 
00 85 71 A9 02 85 
B9 00 02 30 0fi F0 
C8 D0 Fl A9 BD A0 
70 FF GB 85 72 68 
J0 03 N DSCGG" 



PRINT BELL$ 
FOR 1=1 TO LEN(CI] 
+128 : NEXT : 
PRINT BELLS 
& C$ 

PRINT BELL$ 



: POKE 511+I,A5C(MID$(C$,I)) 
POKE 72,0 : CALL -144 



Here's a listing of the machine code installed at 
$300. note the liberal use of Applesoft's own internal 
routines to accomplish the task. Mot everything in 
Applesoft is slow. Instead of picking C$ apart piece by 
piece, the routine moves it en masse into tiie buffer. 
This is where all tiiat time gets saved. Since Applesoft 
stores sfrings in low-value ASCII (0-127) and the 
Monitor expects its commands in high-value ASCII 
(128-255), extra code (from $31C to $32C) is used to 
make die conversion. 



0300: 


A5 71 




LDA 


$71 


Save the temporary string 


0302: 


4B 




PHA 




pointers on the stack. 


0303: 


AS 72 




LDA 


$72 




0305 : 


4B 




PHA 






0306: 


20 E3 


OF 


JSR 


$DFE3 


(FTRGET) Find specified 












string and paint to it. 


0309: 


R5 83 




LOA 


$83 


Transfer string pointer 


0306: 


B5 AB 




SIR $Re 


from where PTRGET put 


030D: 


65 84 




LOR 


$84 


it to where H0VIN5 can 


030F: 


85 RC 




5TA 


$flC 


find it. 


0311: 


A9 00 




LDA 


a$00 


Tell MOVINS ue want to 


0313: 


85 71 




STA 


$71 


move it to page 2 


0315: 


A9 02 




LDA 


»$02 


(the keyboard input 


0317: 


B5 72 




STA 


$72 


buffer ] , 


0319: 


20 04 E5 


JSR 


$E504 


(MOVINS) Do the move. 


031C: 


A0 00 




LDY 


S$00 


Examine relocated string. 


031E: 


89 00 


02 


LDA $0200, Y 


0321: 


30 0ft 




BMI 


$0320 


If lou-vaiue flSCII 


0323: 


F0 08 




BEQ $«32D 


or null, we're done. 


0325: 


09 80 




ORR 


«$B0 


Concert lou-v/alue fiSCII 


0327: 


99 00 


02 


SIR S0200,Y to high -value 


032R: 


C8 




I NY 




Continue till whale string 


032Bt 


00 Fl 




ONE 


$031E 


or all of page 2 is done. 


0320: 


A9 BD 




LDA 


tt$BD 


Place $8D (return) at the 


032F: 


A0 00 




LDY 


H$00 


end of string ($71 points 


0331: 


91 71 




STA 


($71), Y there after M0VIN5). 


0333: 


64 4B 




STY 


$48 


PdI<b 72,0 


0335: 


20 70 FF 


JSR 


$FF70 


Call -144 


0338: 


68 




PLR 






0339: 


as 72 




5TR 


$72 


Restore original teinparary str: 


033B: 


68 




PLfi 




pointer before returning to 


033C: 


85 71 




STR 


$71 


Applesoft . 


033E: 


60 




RTS 







Once the standard Lam has installed Lam a'la 
Ruth, your subsequent Lam applications need only 
define C$ and then fif C$. Better fasten your seat belti 

Clay Ruth 
Dyer, Indiana 

Of the several methods available for entering 
machine language programs from within Basic pro- 
grams (FomFomFom read data mm lam), 

I've always preferred the Lam technique because it is 
very efficient in terms of keystrokes. The other 
methods did have speed advantages, however, until 
now. Thanks for this improvement of an old 
technique. 



